home *** CD-ROM | disk | FTP | other *** search
/ Die Ultimative Software-P…i Collection 1996 & 1997 / Die Ultimative Software-Pakete CD-ROM fur Atari Collection 1996 & 1997.iso / u / utility / packer / crunch / crunch.doc next >
Encoding:
Text File  |  1996-11-17  |  4.6 KB  |  112 lines
  1. Newsgroups: comp.binaries.atari.st
  2. Subject: v06i003: crunch -- Another executable compression program
  3.  
  4. Submitted-by: usqb015@liverpool.ac.uk (Mark Powell)
  5. Posting-number: Volume 6, Issue 3
  6. Archive-name: crunch
  7.  
  8. [Everyone was wondering how this was done -- well, this submission has
  9.  source code!  It is being posted to comp.sources.atari.st. -sg]
  10.  
  11. -----------------------------------------------------------------------------
  12.  
  13.                            Program file cruncher V3.3
  14.  
  15.                         Copyright 5/9/1988 by M.S.Powell
  16.  
  17. File: CRUNCH33.TTP
  18.  
  19. THIS PROGRAM IS PUBLIC DOMAIN. 
  20. Permission is granted to copy this program along with it's documentation
  21. as long as such copying is not for profit.
  22.  
  23.  
  24.      This program will crunch an GEMDOS executable file (i.e. files with ex-
  25. tensions .PRG, .TOS, .TTP & .APP) into another single, but shorter, executable
  26. file, thus using up less disk space, and also loading slightly quicker.
  27. Although this file will be smaller than the original, it will still execute
  28. exactly as did the longer original.
  29.  
  30.      The program requires a command line of the following format:-
  31.  
  32.                            [-[h][d][u][i]] <pathname>
  33.  
  34. Where:-
  35.  
  36. h  Will hold screen when program has finished (useful if you are running from
  37.    the desktop).
  38. d  Will stop the deletion of the original file. (i.e. will give the file the
  39.    extension .CRU if crunching and .UCR if uncrunching instead of using the
  40.    original file extension and thus deleting the original file).
  41. u  Will cause the program to only uncrunch, crunched files, ignoring all others
  42. i  Will cause the program to ignore errors (useful when one file is generating
  43.    a read error)
  44.  
  45. If you use any of the above qualifiers you must precede them all with a '-'
  46. character.
  47.  
  48. <pathname> is a standard GEMDOS path
  49.  
  50. e.g.
  51.  
  52. -hu a:\bits\*.*
  53. Hold screen on exit, uncrunch all files in folder "bits" on drive A.
  54.  
  55. d:\assembler\programs\*.prg
  56. Crunch all .PRG files in folder "programs" in folder "assembler" on drive D.
  57.  
  58. -h *.*
  59. Crunch all files on current drive and hold screen on exit.
  60.  
  61. Crunching files
  62. ---------------
  63.  
  64.      When a file is crunched successfully it will be written back on to disk
  65. with the same name as it had before, thus erasing the original. There is no
  66. need to worry about this though, as if a file doesn't work when crunched it can
  67. be uncrunched and restored to exactly as it was before. This shouldn't happen
  68. though as from about 90+ files I have crunched all have worked perfectly when
  69. crunched (honestly!). (You can disable this deletion of the original file by
  70. specifying the 'd' qualifier in the command line). Some files will of course
  71. not crunch at all and some may only be reduced by a couple of K. However, I
  72. have seen certain program files crunched from 80K to 20K, so large reductions
  73. are quite possible.
  74.  
  75.      Non-executable files will, of course, be ignored by the cruncher.
  76.  
  77.      The aim of this cruncher is to shorten files so that they use up less disk
  78. space, so the cruncher will only write a crunched file, back to disk, if it
  79. does in fact use less disk space, otherwise it will generate the message "File
  80. uncrunchable".
  81.  
  82. Uncrunching files
  83. -----------------
  84.  
  85.      When uncrunching, the uncrunched file will be written back to disk with
  86. the same name as the crunched file had. If you don't wish this to happen then
  87. the 'd' qualifier will cause it to be written with the extension 'UCR'.
  88.  
  89. Running out of memory
  90. ---------------------
  91.  
  92.      If you run out of memory try getting rid of all ram disks, desk ACCs. Copy
  93. the cruncher onto the disk that has the files to be crunched and execute it
  94. from there. If this fails then the only option is to upgrade your memory. A 1
  95. Meg. ST should  be able to crunch any conceivably sized program, although a 520
  96. may have problems with very large program files.
  97.  
  98.      I find the best "crunching" environment is to put the cruncher into a ram
  99. disk as small as possible (i.e. one with about 3K free space) and then
  100. inserting the disks with the programs to be crunched into the floppy drive. You
  101. can then crunch the files by preceding the pathname with the drive number (e.g.
  102. "A:..."). I have the cruncher write over the original files with the crunched
  103. versions,  because  the crunched versions always work and if you wish to get
  104. the original file back you can always uncrunch it. If you would rather the
  105. original not  be  deleted  then  use the 'd' qualifier, although this means
  106. there must be enough free space on the disk to accommodate the new crunched
  107. file.
  108.  
  109. Disclaimer: The author can accept no responsibility for any data loss or any
  110. other form of damage arising from the use of this program.
  111.  
  112.